home *** CD-ROM | disk | FTP | other *** search
/ Aminet 33 / Aminet 33 - October 1999.iso / Aminet / dev / misc / Hexy.readme < prev    next >
Encoding:
Text File  |  1999-09-06  |  7.6 KB  |  183 lines
  1. Short:    Binary file viewer/editor v1.6 (w/src GPL)
  2. Author:   andrew.ab2000@bigfoot.com (Andrew Bell)
  3. Uploader: andrew.ab2000@bigfoot.com (Andrew Bell)
  4. Type:     dev/misc
  5.  
  6. This archive contains the C/Asm source code to Hexy version 1.6 and
  7. the required executable binaries.
  8.  
  9. ------------------------------------------------------------------------
  10. INTRODUCTION
  11.  
  12. Hexy is an unfinished binary file viewer/editor for the Amiga. It has
  13. been released with it's source code under the GNU General Public License.
  14.  
  15. I'm no longer working on this software, feal free to continue working
  16. on it. If you plan to do this, please contact me before hand. I might
  17. be able to assist you.
  18.  
  19. ------------------------------------------------------------------------
  20. FEATURES
  21.  
  22.  o Very fast.
  23.  o ASCII or HEX views
  24.  o Built in editor for HEX and ASCII modes.
  25.  o Supports decompression (via XFD and XPK).
  26.  o Very easy use.
  27.  o View the hunk structure of an executable file. Jump to the location
  28.    of individual hunks and view/edit them.
  29.  o Find window (foward and backward searches).
  30.  o Jump to offset window (support for hex and decimal values).
  31.  o Split large files.
  32.  o Iconification of GUI.
  33.  o Very very free, please send me lots of money if you like it :)
  34.  
  35. ------------------------------------------------------------------------
  36. LIMITATIONS
  37.  
  38.  o Unfinished.
  39.  o Very ugly gadtools GUI, hard coded to a 640x256 hires screen.
  40.  o Never been tested on an NTSC setup.
  41.  o Still some bugs in there.
  42.  o Scroll bar messes up with large files (approx. 4MB).
  43.  o XFD decompression code is buggy i.e. it's not working :o)
  44.  o Poorly documented :o)
  45.  
  46.  (This is why I released it under the GNU GPL, I'm hoping someone
  47.   will update it :)
  48.  
  49. ------------------------------------------------------------------------
  50. REQUIREMENTS
  51.  
  52.  o Amiga OS 3.x
  53.  o reqtools.library version 38+
  54.  o xpkmaster.library version 5 for XPK file decompression.
  55.  o xfdmaster.library for general file decompression.
  56.  
  57. ------------------------------------------------------------------------
  58. USAGE
  59.  
  60.  Sorry for the short document, but Hexy is quite easy to use. When
  61.  viewing a file, use the cursor keys to move around. It is quite
  62.  obvious what all the buttons and pull down menus do.
  63.  
  64.  When editing a file, press the "Edit" tick box. A small cursor will
  65.  appear in the main window. From now on you can edit binary files,
  66.  be careful though! To save a modified file, selected "Save file..." from
  67.  the menu. Press the "Edit" tick box again to stop editing.
  68.  
  69.  Hexy also has a basic Shell interface:
  70.  
  71.  FILE,ASCII/S:
  72.  
  73.  FILE is the name of the file to load.
  74.  ASCII/S forces Hexy to startup in ASCII mode (the default is hex).
  75.  
  76. ------------------------------------------------------------------------
  77. ABOUT THE SOURCE CODE
  78.  
  79. It has been released under the GNU General Public License.
  80.  
  81. To compile it, you need the Amiga OS includes. They have not been included
  82. due to copyright reasons. Hexy was compiled with Hisoft C++ 4.1 using
  83. includes release 40.15.
  84.  
  85. You also need an assember and a linker, I recommend the PhxAss assembler
  86. version 4.39 (or newer) by Frank Wille. It is freely available on the Aminet.
  87.  
  88. Feal free to contact me about the sources via email. Please note, that
  89. Hexy is one of my private projects and was never meant to be released
  90. to the public (and it shows :). It was started in early 1998 and still
  91. contains a lot of bugs :) The source code is a mess, but there may be
  92. some useful hints or tricks in there.
  93.  
  94. One major problem with hexy is the GUI. It stinks, it's hard coded
  95. to a 640x256 hires screen, it's has never been tested on an NTSC
  96. setup. I'd hate to think what would happen on a gfx card system!
  97.  
  98. Another problem with Hexy - it's unfinished.
  99.  
  100. Anyway, I cleaned up the source code, removed some long standing bugs
  101. and fixed it to compile under Hisoft C++ (it was originally compiled
  102. with DICE version 3 by Matt Dillon, now freely available on the Aminet).
  103.  
  104. If I didn't release this source, it would have just sat on my HD forever
  105. - forgotten about. So I've decided to release it under the GNU General
  106. Public License.
  107.  
  108. ------------------------------------------------------------------------
  109. DIRECTORY STRUCTURE
  110.  
  111. The src/ directory contains the source code and the bin/ directory
  112. contains the executable for Hexy. reqtools.library has also been included,
  113. this library is *NOT* covered by the GNU General Public License.
  114.  
  115. ------------------------------------------------------------------------
  116.  
  117. If this source interests you, I'm available for freelance Amiga
  118. programming work. Contact me via my email address below.
  119.  
  120. ------------------------------------------------------------------------
  121.  
  122. This source code and all related files are Copyright © 1999 Andrew Bell.
  123.  
  124. email: andrew.ab2000@bigfoot.com (Andrew Bell)
  125.   WWW: http://www.homeusers.prestel.co.uk/ab2000
  126.  
  127. ------------------------------------------------------------------------
  128.  
  129.            Andrew Bell, Sunday the 22nd of August 1999, 23:45:00
  130.  
  131.                        Going, going, going, gone...
  132.  
  133.  
  134. ============================= Archive contents =============================
  135.  
  136. Original  Packed Ratio    Date     Time    Name
  137. -------- ------- ----- --------- --------  -------------
  138.    50492   23608 53.2% 24-Aug-99 02:47:18 +Hexy.debug
  139.    33492   16725 50.0% 24-Aug-99 02:47:18 +Hexy.exe
  140.    43628   28530 34.6% 24-Aug-99 02:47:18 +reqtools.library
  141.    18007    7009 61.0% 24-Aug-99 02:47:20 +gpl.txt
  142.     4996    2110 57.7% 24-Aug-99 02:47:20 +Hexy.readme
  143.      947     671 29.1% 24-Aug-99 02:47:18 +Hexy.h.info
  144.     2386     572 76.0% 24-Aug-99 02:47:20 +Hexy.project
  145.     2070     962 53.5% 24-Aug-99 02:47:20 +Hexy_asm.h
  146.      947     672 29.0% 24-Aug-99 02:47:20 +Hexy_asm.h.info
  147.    19281    4400 77.1% 24-Aug-99 02:47:20 +Hexy_asm.s
  148.    14756    4013 72.8% 24-Aug-99 02:47:20 +Hexy_edit.c
  149.     1078     734 31.9% 24-Aug-99 02:47:20 +Hexy_edit.c.info
  150.     5004    2776 44.5% 24-Aug-99 02:47:20 +Hexy_edit.mdbi
  151.     9808    2988 69.5% 24-Aug-99 02:47:20 +Hexy_fileio.c
  152.     1042     719 30.9% 24-Aug-99 02:47:20 +Hexy_fileio.c.info
  153.     4318    2454 43.1% 24-Aug-99 02:47:20 +Hexy_fileio.mdbi
  154.    11838    3655 69.1% 24-Aug-99 02:47:20 +Hexy_functions.c
  155.     1132     754 33.3% 24-Aug-99 02:47:20 +Hexy_functions.c.info
  156.     4670    2664 42.9% 24-Aug-99 02:47:20 +Hexy_functions.mdbi
  157.    28284    6912 75.5% 24-Aug-99 02:47:20 +Hexy_guicontrol.c
  158.     1444     857 40.6% 24-Aug-99 02:47:20 +Hexy_guicontrol.c.info
  159.     2281    1057 53.6% 24-Aug-99 02:47:20 +Hexy_guicontrol.h
  160.     7952    4346 45.3% 24-Aug-99 02:47:20 +Hexy_guicontrol.mdbi
  161.    17761    4846 72.7% 24-Aug-99 02:47:20 +Hexy_main.c
  162.     1101     742 32.6% 24-Aug-99 02:47:20 +Hexy_main.c.info
  163.     1909    1001 47.5% 24-Aug-99 02:47:18 +Hexy_main.h
  164.     5646    3173 43.8% 24-Aug-99 02:47:20 +Hexy_main.mdbi
  165.     6770    2087 69.1% 24-Aug-99 02:47:20 +Hexy_protos.h
  166.     1121     623 44.4% 24-Aug-99 02:47:20 +Hexy_rev.h
  167.      324     155 52.1% 24-Aug-99 02:47:20 +Hexy_rev.i
  168.        2       2  0.0% 24-Aug-99 02:47:18 +Hexy_rev.rev
  169.    10141    3333 67.1% 24-Aug-99 02:47:20 +Hexy_wb.c
  170.     1154     768 33.4% 24-Aug-99 02:47:20 +Hexy_wb.c.info
  171.     4448    2535 43.0% 24-Aug-99 02:47:20 +Hexy_wb.mdbi
  172.     6551    1865 71.5% 24-Aug-99 02:47:20 +Hexy_winfind.c
  173.     1016     711 30.0% 24-Aug-99 02:47:20 +Hexy_winfind.c.info
  174.     3734    2070 44.5% 24-Aug-99 02:47:20 +Hexy_winfind.mdbi
  175.    10683    2894 72.9% 24-Aug-99 02:47:20 +Hexy_winhunk.c
  176.     1112     748 32.7% 24-Aug-99 02:47:20 +Hexy_winhunk.c.info
  177.     4514    2539 43.7% 24-Aug-99 02:47:20 +Hexy_winhunk.mdbi
  178.     3686    1478 59.9% 24-Aug-99 02:47:20 +Hexy_winjump.c
  179.     1016     709 30.2% 24-Aug-99 02:47:20 +Hexy_winjump.c.info
  180.     3454    1906 44.8% 24-Aug-99 02:47:20 +Hexy_winjump.mdbi
  181. -------- ------- ----- --------- --------
  182.   355996  153373 56.9% 24-Aug-99 18:25:14   43 files
  183.